/**
 ******************************************************************************
 * @file    stm32f4xx_dbgmcu.c
 * @author  MCD Application Team
 * @version V1.8.0
 * @date    04-November-2016
 * @brief   This file provides all the DBGMCU firmware functions.
 ******************************************************************************
 * @attention
 *
 * <h2><center>&copy; COPYRIGHT 2016 STMicroelectronics</center></h2>
 *
 * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
 * You may not use this file except in compliance with the License.
 * You may obtain a copy of the License at:
 *
 *        http://www.st.com/software_license_agreement_liberty_v2
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 ******************************************************************************
 */

/* Includes ------------------------------------------------------------------*/
#include "stm32f4xx_dbgmcu.h"

/** @addtogroup STM32F4xx_StdPeriph_Driver
 * @{
 */

/** @defgroup DBGMCU
 * @brief DBGMCU driver modules
 * @{
 */

/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/
#define IDCODE_DEVID_MASK ((uint32_t)0x00000FFF)

/* Private macro -------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/* Private function prototypes -----------------------------------------------*/
/* Private functions ---------------------------------------------------------*/

/** @defgroup DBGMCU_Private_Functions
 * @{
 */

/**
 * @brief  Returns the device revision identifier.
 * @param  None
 * @retval Device revision identifier
 */
uint32_t DBGMCU_GetREVID(void)
{
    return (DBGMCU->IDCODE >> 16);
}

/**
 * @brief  Returns the device identifier.
 * @param  None
 * @retval Device identifier
 */
uint32_t DBGMCU_GetDEVID(void)
{
    return (DBGMCU->IDCODE & IDCODE_DEVID_MASK);
}

/**
 * @brief  Configures low power mode behavior when the MCU is in Debug mode.
 * @param  DBGMCU_Periph: specifies the low power mode.
 *   This parameter can be any combination of the following values:
 *     @arg DBGMCU_SLEEP: Keep debugger connection during SLEEP mode
 *     @arg DBGMCU_STOP: Keep debugger connection during STOP mode
 *     @arg DBGMCU_STANDBY: Keep debugger connection during STANDBY mode
 * @param  NewState: new state of the specified low power mode in Debug mode.
 *   This parameter can be: ENABLE or DISABLE.
 * @retval None
 */
void DBGMCU_Config(uint32_t DBGMCU_Periph, FunctionalState NewState)
{
    /* Check the parameters */
    assert_param(IS_DBGMCU_PERIPH(DBGMCU_Periph));
    assert_param(IS_FUNCTIONAL_STATE(NewState));
    if (NewState != DISABLE) {
        DBGMCU->CR |= DBGMCU_Periph;
    } else {
        DBGMCU->CR &= ~DBGMCU_Periph;
    }
}

/**
 * @brief  Configures APB1 peripheral behavior when the MCU is in Debug mode.
 * @param  DBGMCU_Periph: specifies the APB1 peripheral.
 *   This parameter can be any combination of the following values:
 *     @arg DBGMCU_TIM2_STOP: TIM2 counter stopped when Core is halted
 *     @arg DBGMCU_TIM3_STOP: TIM3 counter stopped when Core is halted
 *     @arg DBGMCU_TIM4_STOP: TIM4 counter stopped when Core is halted
 *     @arg DBGMCU_TIM5_STOP: TIM5 counter stopped when Core is halted
 *     @arg DBGMCU_TIM6_STOP: TIM6 counter stopped when Core is halted
 *     @arg DBGMCU_TIM7_STOP: TIM7 counter stopped when Core is halted
 *     @arg DBGMCU_TIM12_STOP: TIM12 counter stopped when Core is halted
 *     @arg DBGMCU_TIM13_STOP: TIM13 counter stopped when Core is halted
 *     @arg DBGMCU_TIM14_STOP: TIM14 counter stopped when Core is halted
 *     @arg DBGMCU_RTC_STOP: RTC Calendar and Wakeup counter stopped when Core is halted.
 *     @arg DBGMCU_WWDG_STOP: Debug WWDG stopped when Core is halted
 *     @arg DBGMCU_IWDG_STOP: Debug IWDG stopped when Core is halted
 *     @arg DBGMCU_I2C1_SMBUS_TIMEOUT: I2C1 SMBUS timeout mode stopped when Core is halted
 *     @arg DBGMCU_I2C2_SMBUS_TIMEOUT: I2C2 SMBUS timeout mode stopped when Core is halted
 *     @arg DBGMCU_I2C3_SMBUS_TIMEOUT: I2C3 SMBUS timeout mode stopped when Core is halted
 *     @arg DBGMCU_CAN2_STOP: Debug CAN1 stopped when Core is halted
 *     @arg DBGMCU_CAN1_STOP: Debug CAN2 stopped when Core is halted
 *   This parameter can be: ENABLE or DISABLE.
 * @retval None
 */
void DBGMCU_APB1PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState)
{
    /* Check the parameters */
    assert_param(IS_DBGMCU_APB1PERIPH(DBGMCU_Periph));
    assert_param(IS_FUNCTIONAL_STATE(NewState));

    if (NewState != DISABLE) {
        DBGMCU->APB1FZ |= DBGMCU_Periph;
    } else {
        DBGMCU->APB1FZ &= ~DBGMCU_Periph;
    }
}

/**
 * @brief  Configures APB2 peripheral behavior when the MCU is in Debug mode.
 * @param  DBGMCU_Periph: specifies the APB2 peripheral.
 *   This parameter can be any combination of the following values:
 *     @arg DBGMCU_TIM1_STOP: TIM1 counter stopped when Core is halted
 *     @arg DBGMCU_TIM8_STOP: TIM8 counter stopped when Core is halted
 *     @arg DBGMCU_TIM9_STOP: TIM9 counter stopped when Core is halted
 *     @arg DBGMCU_TIM10_STOP: TIM10 counter stopped when Core is halted
 *     @arg DBGMCU_TIM11_STOP: TIM11 counter stopped when Core is halted
 * @param  NewState: new state of the specified peripheral in Debug mode.
 *   This parameter can be: ENABLE or DISABLE.
 * @retval None
 */
void DBGMCU_APB2PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState)
{
    /* Check the parameters */
    assert_param(IS_DBGMCU_APB2PERIPH(DBGMCU_Periph));
    assert_param(IS_FUNCTIONAL_STATE(NewState));

    if (NewState != DISABLE) {
        DBGMCU->APB2FZ |= DBGMCU_Periph;
    } else {
        DBGMCU->APB2FZ &= ~DBGMCU_Periph;
    }
}

/**
 * @}
 */

/**
 * @}
 */

/**
 * @}
 */

/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
